Visual Studio 中的项目属性设置

.NET MAUI 使用 单项目系统 来管理跨平台应用的配置。 .NET MAUI 中的项目配置类似于 Visual Studio 中的其他项目，右键单击解决方案资源管理器中的项目，然后选择“属性”。

“应用程序”部分介绍与应用面向的平台相关的一些设置，以及输出文件和默认命名空间。

常规

介绍有关应用的一些基本设置。

iOS 目标

如果要使用 Mac Catalyst) 面向 iOS 和 macOS (，这些设置描述目标 iOS 版本。

Android 目标

如果要面向 Android，这些设置描述目标 Android 版本。

Windows 目标

如果要面向 Windows，这些设置描述目标 Windows 版本。

“ 生成 ”部分介绍与编译应用相关的设置。

与目标平台相关的设置。

“条件编译符”号

指定要在其上执行条件编译的符号。 用分 ;号 分隔符号 。 符号可以分解为目标平台。 有关详细信息，请参阅 条件编译。

平台目标

指定将作为输出文件目标的处理器。 选择 Any CPU 指定任何处理器都是可接受的，从而允许应用程序在最广泛的硬件上运行。

通常将其设置为 Any CPU ，运行时标识符设置用于面向 CPU 平台。

可以为 Null

指定项目范围内可以为 null 的 C# 上下文。 有关详细信息，请参阅 可为空引用。

隐式全局使用

允许项目 SDK 声明隐式全局使用。 默认情况下启用此功能，并将许多 .NET MAUI 命名空间自动导入到所有代码文件中。 代码文件不需要为常见的 .NET MAUI 命名空间添加 using 语句。 有关详细信息，请参阅 MSBuild 属性 - ImplicitUsings。

不安全代码

允许使用 unsafe 关键字 (keyword) 的代码进行编译。 此项已默认禁用。

优化代码

启用编译器优化以实现更小、更快、更高效的输出。 在调试或发布模式下，每个目标平台都有一个选项。 通常，这是为发布模式启用的，因为代码已针对速度进行优化，但牺牲了有用的调试信息。

调试符号

指定生成期间生成的调试符号的类型。

与编译期间如何处理和报告错误和警告相关的设置。

警告级别

指定编译器警告的显示等级。

禁止显示特定警告

阻止编译器生成指定的警告。 用逗号 , 或分 ;号 分隔多个警告号。

将警告视为错误

启用后，指示编译器将警告视为错误。 此项已默认禁用。

将特定警告视为错误

指定哪些警告被视为错误。 用逗号 , 或分 ;号 分隔多个警告号。

与生成输出文件相关的设置。

基本输出路径

指定生成期间项目输出的基位置。 子文件夹将追加到此路径以区分项目配置。

默认为 .\bin\。

基中间输出路径

指定生成期间项目中间输出的基位置。 子文件夹将追加到路径以区分项目配置。

默认为 .\obj\。

引用程序集

启用后，生成包含项目公共 API 的引用程序集。 此项已默认禁用。

文档文件

启用后，将生成一个包含 API 文档的文件。 此项已默认禁用。

在本部分中，可以添加在生成期间运行的命令。

预生成事件

指定在生成开始之前运行的命令。 如果项目是最新的，则不运行。 非零退出代码将在运行前使生成失败。

生成后事件

指定在生成开始之前运行的命令。 如果项目是最新的，则不运行。 非零退出代码将在运行前使生成失败。

何时运行生成后事件

指定在哪种条件下运行生成后甚至。

与为程序集签名相关的设置。

对程序集进行签名

启用后，对输出程序集进行签名以为其指定强名称。

与生成相关的其他设置。

语言版本

项目中代码可用的语言版本。 默认为 10.0。

检查算术溢出

当整数算术生成的值超过范围时引发异常。 此设置适用于每个平台。 默认为每个平台禁用。

具有确定性

为相同的输入生成相同的编译输出。 此设置适用于每个平台。 默认为每个平台启用。

内部编译器错误报告

向 Microsoft 发送内部编译器错误报告。 默认为 Prompt before sending。

文件对齐方式

指定输出文件各部分的对齐位置，以字节为单位。 此设置适用于每个平台。 每个平台的 512 默认值为 。

“ 包 ”部分介绍与生成 NuGet 包相关的设置。

与生成 NuGet 包相关的设置。

生成时生成 NuGet 包

启用后，在生成操作期间生成 NuGet 包文件。 此项已默认禁用。

包 ID

不区分大小写的包标识符，该标识符在 NuGet 包库中必须是唯一的，例如 nuget.org。ID 不能包含对 URL 无效的空格或字符，并且通常遵循 .NET 命名空间规则。

默认为 的 MSBuild 值 $(AssemblyName)。

标题

明了易用的包标题，通常用在 UI 显示中，如 nuget.org 上和 Visual Studio 中包管理器上的那样。

包版本

包的版本，遵循模式 major.minor.patch 。 版本号可能包含预发行后缀。

默认为 的 MSBuild 值 $(ApplicationDisplayVersion)。

作者

以逗号分隔的作者列表，与 nuget.org 上的配置文件名称匹配。它们显示在 nuget.org 上的 NuGet 库中，并用于由同一作者交叉引用包。

默认为 的 MSBuild 值 $(AssemblyName)。

Company

与 NuGet 包关联的公司的名称。

默认为 的 MSBuild 值 $(Authors)。

Product

与 NuGet 包关联的产品名称。

默认为 的 MSBuild 值 $(AssemblyName)。

说明

用于显示 UI 的包的说明。

版权

包的版权详细信息。

项目 URL

包的主页 URL，通常显示在 UI 中以及 nuget.org 中。

图标

包的图标图像。 图像文件大小限制为 1 MB。 支持的文件格式包括 JPEG 和 PNG。 建议使用 128x128 的图像分辨率。

自述文件

包的自述文件文档。 必须是 Markdown (.md) 文件。

存储库 URL

指定存储库的 URL，该存储库是包的源代码所驻留和/或生成的位置。 若要链接到项目页，请改用“项目 URL”字段。

存储库类型

指定存储库的类型。 默认值为“git”。

标记

以分号分隔的标记和关键字列表，用于描述包，并通过搜索和筛选帮助发现包。

发行说明

对包发布中所做的更改的说明，通常用于 UI 中，例如 Visual Studio 包管理器的“汇报”选项卡来代替包说明。

打包为 .NET 工具

启用后，将项目打包为一个特殊包，其中包含可通过“dotnet tool”命令安装的控制台应用程序。 此项已默认禁用。

包输出路径

确定将删除包的输出路径。

默认为 的 MSBuild 值 $(OutputPath)。

程序集中性语言

哪种语言代码被视为非特定语言。 默认为未设置。

程序集版本

程序集的版本，如果未设置，则 1.0.0.0 默认为 。

文件版本

与文件关联的版本，如果未设置，则 1.0.0.0 默认为 。

包许可证

指定项目包的许可证。 默认为 None。

符号

生成符号包

启用后，在打包项目时创建其他符号包。 此项已默认禁用。

与代码分析相关的设置。

与分析运行时间相关的设置。

在生成时运行

启用后，在生成时运行代码分析。 默认为启用。

在实时分析中运行

启用后，键入时在编辑器中实时运行代码分析。 默认为启用。

与 .NET 分析器相关的设置。

在生成 (实验性) 强制实施代码样式

启用后，生成有关生成时代码样式的诊断。 此项已默认禁用。

启用 .NET 分析器

启用后，运行 .NET 分析器以帮助使用 API。 默认为启用。

分析级别

应在项目中运行的分析器集。 默认为 Latest。 有关详细信息，请参阅 MSBuild：AnalysisLevel。

这些是在所有目标平台之间共享的 .NET MAUI 项目设置。

与 .NET MAUI 相关的常规设置。

应用程序标题

应用程序的显示名称。

应用程序 ID

反向域名格式的应用程序标识符，例如： com.microsoft.maui。

应用程序 ID (GUID)

采用 GUID 格式的应用程序标识符。

应用程序显示版本

应用程序的版本。 这应该是个位数整数。 默认为 1。

这些是特定于 Android 的 .NET MAUI 设置。

与 Android 清单相关的设置。

应用程序名称

显示为应用程序名称的字符串。 这是应用标题栏中显示的名称。 如果未设置，则应用的 MainActivity 标签将用作应用程序名称。 默认设置为 @string/app_name，它引用 中的Resources/values/Strings.xaml字符串资源app_name位置。

应用程序包名称

用于唯一标识应用程序的字符串。 通常，包名称基于反向 Internet 域名约定，例如 com.company.appname。

应用程序图标

指定将为应用显示的应用程序图标资源。 设置@drawable/icon引用文件夹中Resources/mipmap的图像文件icon.png。

应用程序主题

设置应用于整个应用的 UI 样式。 应用中的每个视图都适用于所选主题中定义的样式属性。

应用程序版本号

一个大于零的整数值，用于定义应用的版本号。 数字越大，表示最新版本越好。 此值由 Android 和其他应用以编程方式计算，不会向用户显示。

应用程序版本名称

一个字符串，用于向用户指定应用的版本。 版本名称可以是原始字符串，也可以是对字符串资源的引用。

安装位置

指示应用的存储位置（无论是内部存储还是外部存储）的首选项。

最低 Android 版本

可以安装和运行应用的 Android 设备中最早的 API 级别。 minSdkVersion也称为 。

目标 Android 版本

应用预期运行的 Android 设备的目标 API 级别。 此 API 级别在运行时使用，与在生成时使用的目标框架不同。 Android 使用此版本作为提供向前兼容性的一种方式。 targetSdkVersion也称为 ，这应与目标框架 compileSdkVersion匹配。

用于生成 Android 应用的其他选项。

Android 包格式

apk或 bundle，分别将 Android 应用程序打包为 APK 文件或 Android 应用捆绑包。 可以为调试模式和发布模式单独设置此值。

应用捆绑包是用于在 Google Play 上提交的 Android 版本的最新格式。

默认值是 apk。

选择 时 bundle ，将设置其他 MSBuild 属性：

仅) 调试模式 (快速部署

启用后，将比平时更快地将应用部署到目标设备。 此过程可加快生成/部署/调试周期，因为仅更改程序集时不会重新安装包。 只有更新的程序集才会重新同步到目标设备。

此项已默认启用。

按 ABI 生成

启用后， (ABI) 为每个所选应用程序二进制接口生成一个 Android 包 (apk) 。 此项已默认禁用。

使用增量打包

启用后，使用增量 Android 打包系统 (aapt2) 。 此项已默认启用。

Multi-dex

启用后，允许 Android 生成系统使用 multidex。 默认为禁用。

代码收缩器

选择要使用的代码收缩器。

未压缩的资源

使指定的资源扩展保持未压缩状态。 使用分 ;号 分隔扩展。 例如：.mp3;.dll;.png。

开发人员检测

启用后，会为调试和分析提供开发人员检测。 对于“调试”和“发布”模式，可以单独设置此值。

默认为调试版本启用。

调试器

选择要使用的调试器。 默认值为 .NET (Xamarin)，用于托管代码。 可以选择 C++ 调试器来调试应用使用的本机库。

AOT

启用预先 (AOT) 编译。 对于“调试”和“发布”模式，可以单独设置此值。

默认为发布版本启用。

LLVM

启用 LLVM 优化编译器。 默认为禁用。

启动跟踪

启用启动跟踪。 对于“调试”和“发布”模式，可以单独设置此值。

默认为发布版本启用。

垃圾回收

启用后，使用并发垃圾回收器。 默认为启用。

启用剪裁

启用后，在发布期间剪裁应用程序。 对于“调试”和“发布”模式，可以单独设置此值。 有关详细信息，请参阅 剪裁独立部署和可执行文件 和 剪裁选项。

默认为发布版本启用。

剪裁粒度

控制放弃 IL 的主动程度。 有两种模式可供选择：

Java 最大堆大小

设置此值可增加应用可以使用的内存大小。 例如，值 将 2G 堆大小增加到 2 GB。 请注意，无法保证堆的大小，并且请求过多的堆内存可能会强制其他应用过早终止。

默认为 1G。

其他 Java 选项

指定要在生成 .dex 文件时传递给 Java 编译器的其他命令行选项。 在命令行中，可以键入 java -help 以查看可用选项。

启用后，对 进行签名 。 使用密钥存储详细信息的 APK 文件。 此项已默认禁用。

这些是特定于 iOS 的 .NET MAUI 设置。

与生成 iOS 应用相关的设置。

链接器行为

链接器可以去除未使用的方法、属性、字段、事件、结构甚至类，以减小应用程序的总体大小。 可以向其中任何一个 Preserve 添加属性，以防止链接器在序列化或反射需要时将其剥离。

警告

启用此功能可能会妨碍调试，因为它可能会去除属性访问器，以便检查对象的状态。

选项包括：

LLVM

启用后，使用 LLVM 优化编译器。 对于“调试”和“发布”模式，可以单独设置此值。

默认为发布版本启用。

Float 操作

将所有 32 位浮点运算作为 64 位浮点运算执行。

符号

启用后，将从输出中去除本机调试符号。 此项已默认启用。

垃圾回收器

启用后，使用并发垃圾回收器。 此项已默认禁用。

其他参数

要传递给应用程序捆绑代码的其他命令行参数。

优化

启用后， 优化.PNG 映像。 此项已默认启用。

这些设置与生成和签名应用捆绑包相关。

Scheme

为捆绑包配置签名方案。 可以将其设置为以下值之一：

对标识进行签名

签名标识是证书和私钥对，用于使用 Apple 的 codeign 实用工具对应用捆绑包进行代码签名。

预配配置文件

预配配置文件是一种使用应用 ID 和测试设备列表将开发人员团队捆绑在一起的一种方式。 预配配置文件列表经过筛选，仅显示与 Info.plist 中设置的所选标识和应用 ID (又称捆绑标识符) 匹配的预配配置文件。 如果要查找的预配配置文件不在列表中，请确保选择了一个兼容的标识，并且双检查 Info.plist 中设置的捆绑标识符是正确的。

自定义权利

要用于权利的 plist 文件。 有关详细信息，请参阅 权利。

自定义资源规则

包含 Apple 的 codesign 实用工具使用的自定义规则的 plist 文件。

注意

从 Mac OSX 10.10 开始，Apple 已弃用自定义资源规则。 因此，除非绝对必要，否则应避免此设置。

其他参数

在生成的代码签名阶段，要传递给 Apple codeign 实用工具的其他命令行参数。

这些是与调试相关的设置。

调试

启用后，将打开调试。 默认值基于当前配置文件。 调试配置文件启用调试，而发布配置文件禁用调试。

分析

启用后，将打开分析。

启用后， (IPA) 生成 iTunes 包存档。

与按需资源相关的设置。 有关详细信息，请参阅 Apple 开发人员文档 - 按需资源概要。

初始标记

从应用商店下载应用的同时下载的按需资源的标记。 用分号 ;分隔标记。

预提取订单

安装应用后下载的按需资源的标记。 用分号 ;分隔标记。

Embed

启用后，在应用捆绑包中嵌入按需资源。 此项已默认启用。 禁用此设置以使用 Web 服务器。

Web server

托管按需资源的 Web 服务器的 URI。

与在 iOS 或 macOS 设备上运行应用相关的选项。

执行模式

此设置确定应用在目标设备上的运行方式。

启动参数

在设备上启动时要传递给应用的其他命令行参数。

额外的 mlaunch 参数

要传递给 mlaunch 的其他命令行参数。

环境变量

在设备上运行应用时要设置的环境变量的名称-值对。